A react-native marquee label component.
If you need a vertical marquee label, please use react-native-lahk-marquee-label-vertical.
Skip this part, go to #Install
I needed a marquee label in one of my recent project and I didn't find a good one online, so I decided to create my own marquee label component.
I intended to make it work well on both iOS and Android, still there remains one thing in iOS which I cannot fix. I found that in iOS, when you use View
component to wrap child components and don't explicitly set the parent View
component width (e.g. use flex
), the parent View
component will have the same width as it's child.
It becomes a problem in this custom component because I use a child View
component to wrap Text
component in order to make the text expand and show in one line. I set the text containner View
component size to be bigger than the Text
so that it will not have multiple lines nor have the overflow text replaced by ellipsis. The default value of text container width is 1000, which is usually larger than the actual label width. This results in the problem mentioned above, the wrapper View
width becomes 1000 also.
<View class="marquee-label">
<View class="marquee-label-text-container">
<Text class="marquee-label-text">{text}</Text>
</View>
</View>
Note:
- In Andorid, you can use both
width
orflex
to layout the view. - In iOS, use
width
to layout the view.flex
layout is not supported.
npm install --save react-native-lahk-marquee-label
- Import
import MarqueeLabel from 'react-native-lahk-marquee-label';
- Use
<MarqueeLabel
duration={8000}
text={'This is a Marquee Label.'}
textStyle={{ fontSize: 13, color: 'white' }}
/>
or
<MarqueeLabel
speed={250}
textStyle={{ fontSize: 13, color: 'white' }}
>
This is a Marquee Label.
</MarqueeLabel>
children
: string, the text to show in the marquee. Alternative totext
.text
: string, the text to show in the marquee. Alternative tochildren
.duration
: number(unit: millisecond), the duration for the marquee to run one round. e.g. 6000 (for 6 seconds a round). Alternative tospeed
.speed
: number(unit: px/s, px per second), the speed of the marquee. Alternative toduration
.bgViewStyle
: stylesheet object, background view component custom styles.textStyle
: stylesheet object, text component custom styles.textContainerWidth
: number, text container component width. If the text is not shown in one line, increase this value.textContainerHeight
: number, text container component height. If the text is not shown in one line, increase this value.textContainerStyle
: stylesheet object, not recommended to use, text containner component custom style.
我在一个项目中需要用到跑马灯,但是在网上没找到好用的。所以我就自己写了一个跑马灯的组件。
本来打算让它可以在 iOS 和 Android 平台上都好用的,不过还是在 iOS 平台上存在一个问题没法解决。
我发现在 iOS 平台上,当使用 View
组件来包裹子组件的时候,如果没有显示设置父级 View
组件的宽度(width 样式)(比如用 flex
布局),那么父级 View
组件的宽度会被自动设置成子组件的宽度。(至少当子组件比父组件宽度大时是这样的,另外一种情况我没有做试验。)
我的跑马灯组件中的问题在于,我用了一个子级 View
组件来包裹 Text
组件以保证文字是在一行全部显示。通过将 text container 的宽度设置得比 Text
组件宽度大,保证了文字不会换行,也不会用省略号替换溢出文字。 text container 默认宽度为 1000,这比一般的跑马灯标签实际宽度要大。而这也就导致了上述的问题,最外层的 View
的宽度也变成了 1000。
<View class="marquee-label">
<View class="marquee-label-text-container">
<Text class="marquee-label-text">{text}</Text>
</View>
</View>
因此要注意:
- 在 Android 平台上,通过
width
或者flex
布局来设置最外层View
的样式都没问题。 - 在 iOS 平台上,请使用并且只能使用
width
来设置样式。