帮酷LOGO
0 0 评论
  • 显示原文与译文双语对照的内容
文章标签:效果  saf  ZOO  VIEW  Effect  Ripple  添加  HIG  
Add ripple, highlight and zoom effects to your views, simple & safely!

  • 源代码名称:RippleDecoratorView
  • 源代码网址:http://www.github.com/thomsonreuters/RippleDecoratorView
  • RippleDecoratorView源代码文档
  • RippleDecoratorView源代码下载
  • Git URL:
    git://www.github.com/thomsonreuters/RippleDecoratorView.git
  • Git Clone代码到本地:
    git clone http://www.github.com/thomsonreuters/RippleDecoratorView
  • Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/thomsonreuters/RippleDecoratorView
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
  • 波纹装饰器视图

    RippleDecoratorView是一个小部件库,带有用于包装任何布局的视图。 它允许你在任何触摸中添加动画效果,例如: 波纹笔触,波纹填充,高亮显示和缩放。 这些动画带有可以配置的淡入淡出,淡出时间线。

    它不会捕获触摸,所以你可以在你的XML布局文件中安全地。

    Example

    用法

    将自定义命名空间( app,rdv,你的选择) 导入到你的布局中,在android架构下面:

     xmlns:rdv="http://schemas.android.com/apk/res-auto"

    然后用 com.thomsonreuters.rippledecoratorview.RippleDecoratorView 元素包装任何布局:

     <com.thomsonreuters.rippledecoratorview.RippleDecoratorView
     android:layout_width="wrap_content"android:layout_height="wrap_content"android:layout_gravity="center_horizontal"android:layout_margin="4dp"rdv:rdv_rippleColor="@android:color/holo_blue_dark"rdv:rdv_rippleAnimationFrames="60"rdv:rdv_rippleAnimationPeakFrame="15"rdv:rdv_rippleMaxAlpha="0.8"rdv:rdv_rippleAnimationDuration="600"rdv:rdv_rippleRadius="50dp">
     <Buttonandroid:layout_width="wrap_content"android:layout_height="wrap_content"android:padding="4dp"/>
     </com.thomsonreuters.rippledecoratorview.RippleDecoratorView>
    生命周期

    这些方法可以帮助你以编程方式处理动画生命周期。 你可以使用 Configuration 中描述的none 触发器来使动画仅在使用本节中的方法激活时进行。

     
    doAnimation
    
    
    
     

    在给定的X,Y 位置开始动画。 如果动画已经在运行,则不执行任何操作。

     
    cancelAnimation
    
    
    
     

    停止动画。如果动画已经停止,则不执行任何操作。 不取消缩放动画。

    当重新创建一个位置时,建议在适配器视图内调用以避免视图回收,从而导致在不需要的位置播放动画。

    配置

    RippleDecoratorView允许通过XML属性或者方法调用进行配置。 对于下面描述的每个属性,都有一个getProperty和setProperty方法。

    纹波

    
    rdv_rippleAnimationTrigger
    
    
    
    

    当波纹动画播放时: 无,onTap,onTouchDown或者 onTouchUp。 默认值:onTap。

     
    rdv_rippleColor
    
    
    
     

    更改波纹的颜色。 默认:白色。

     
    rdv_rippleStyle
    
    
    
     

    改变波纹样式:笔触只绘制轮廓,填充绘制完整圆。 默认值:笔划。

    
    rdv_rippleCentered
    
    
    
    

    涟漪是否源自接触点或者视图的中心。 默认值:false。

     
    rdv_rippleRadius
    
    
    
     

    波纹的半径如果 -1,则采用视图的大小。 默认值:-1.

    
    rdv_ripplePadding
    
    
    
    

    如果半径是视图的大小,则半径大小将减少该值。 默认值:0.

    
    rdv_rippleMaxAlpha
    
    
    
    

    动画过程中波纹达到的最大透明度。 默认值:1.

    突出显示

    除了纹波外,还可以显示高光。 它以颜色覆盖整个视图。

    
    rdv_highlightAnimation
    
    
    
    

    是否应用高光效果。 默认值:false。

    
    rdv_highlightColor
    
    
    
    

    高光效果的颜色。 默认值:与rdv_rippleColor相同。

    
    rdv_highlightMaxAlpha
    
    
    
    

    动画过程中突出显示的最大透明度。 默认值:0,2.

    缩放

    除了波纹和突出显示外,缩放动画还有一点缩放。 警告:缩放动画一旦启动就无法取消,请谨慎使用。

    
    rdv_zoomAnimation
    
    
    
    

    是否播放缩放动画。 默认值:false。

    
    rdv_zoomAnimationScale
    
    
    
    

    视图缩放的比例。 默认值:1,03。

    
    rdv_zoomAnimationTrigger
    
    
    
    

    当缩放动画播放时: 无,onTap,onTouchDown或者 onTouchUp。 默认值:onTap。

    微调动画

    默认情况下,RippleDecoratorView有淡入,淡出动画为波纹和突出显示,在可选缩放的顶部。 库用户可以将这里动画的时间线配置为它的需要。

    API设计如动画持续时间以毫秒为单位,帧值表示动画的每个步骤。 动画以持续时间/帧速率进行更新。 例如一个持续 1000毫秒且具有 60帧的动画将在每次 16.6毫秒后更新自身。 高帧值可能会导致更新率比导致"除去"帧的屏幕更频繁。 低帧值可能看起来不平滑。 建议保留默认值或者查找任何给定持续时间的最佳位置。

    
    rdv_rippleAnimationDuration
    
    
    
    

    完成涟漪/高光动画所需的时间,以毫秒计。 默认值:400.

    
    rdv_rippleAnimationFrames
    
    
    
    

    动画被划分为的帧数。 默认值:60.

    
    rdv_zoomAnimationDuration
    
    
    
    

    完成缩放动画所需的时间,以毫秒计。 默认值:与rdv_rippleAnimationDuration相同。

    峰值帧

    峰值帧定义在动画改变行为时定义时间轴中的关键帧。 例如 1000毫秒动画,10帧和 7上峰值将淡入 0,7秒,然后淡入 0,3秒。

    
    rdv_rippleAnimationPeakFrame
    
    
    
    

    当动画从淡入淡出到淡出时,定义为涟漪。 默认值:与rdv_rippleAnimationFrames相同。

    
    rdv_highlightAnimationPeakFrame
    
    
    
    

    当动画从淡入淡出到淡出时,定义为突出显示。 默认值:与rdv_rippleAnimationFrames相同。

    插值

    虽然XML不能使用插值,但它的值可以通过代码检索和修改。

     
    interpolator
    
    
    
     

    为波纹和高光定义插值器。 默认值:LinearInterpolator。

     
    zoomInterpolator
    
    
    
     

    定义缩放的插值器。 默认值:LinearInterpolator。

    示例

    存储库中有一个名为rippledecoratorview示例的MODULE,展示。

    分配和安装

    从 Maven 中心下载最新的服务器。

    或者

    将它作为你的build.gradle的依赖项添加

    repositories {
     ...
     mavenCentral()
     ...
     }
     dependencies {
     ...
     compile 'com.thomsonreuters:rippledecoratorview:+'...
     }

    或者

    repositories {
     ...
     maven {
     url "https://jitpack.io" }
     ...
     }
     dependencies {
     ...
     compile 'com.github.thomsonreuters:RippleDecoratorView:v1.0.2'...
     }
    联系人

    旧金山 Estevez francisco.estevezgarcia@thomsonreuters.com

    许可证

    Apache软件许可证,版本 2.0

    查看 LICENSE.md



    文章标签:添加  VIEW  HIG  Effect  saf  查看  效果  ZOO  

    Copyright © 2011 HelpLib All rights reserved.    知识分享协议 京ICP备05059198号-3  |  如果智培  |  酷兔英语