Range区域选择

允许用户在一个区间中选择特定值,eg:控制屏幕的显示亮度。

规则

  • 默认状态下,左边为最小值,右边为最大值。
  • 一般水平放置。

Common API

属性类型默认值说明
ngModelNumber设置当前取值,可双向绑定。
ngModelChangeFunctionNoop当 Slider 的值发生改变时,会触发 ngModelChange 事件,并把改变后的值作为参数传入。
minNumber0最小值
maxNumber100最大值
stepNumber or null1步长,取值必须大于 0,并且可被 (max - min) 整除。当 marks 不为空对象时,可以设置 stepnull,此时 Slider 的可选值仅有 marks 标出来的部分。
value[Number, Number]-设置当前取值。
defaultValue[Number, Number][0, 0]设置初始取值。
disabledBooleanfalse值为 true 时,滑块为禁用状态
onChangeFunctionNoop当 Slider 的值发生改变时,会触发 onChange 事件,并把改变后的值作为参数传入。
onAfterChangeFunctionNoopontouchend 触发时机一致,把当前值作为参数传入。
marksObject{Number:String}{ }刻度标记,key 的类型必须为 Number 且取值在闭区间 [min, max] 内
countnumber1Determine how many ranges to render, and multiple handles will be rendered (number + 1).
allowCrossbooleantrueallowCross could be set as true to allow those handles to cross.
pushablenumberminimum ensured distance between handles
handleStyleArray[Object]-滑块的样式,按数组顺序应用到多滑块
trackStyleArray[Object]-选中部分滑动条的样式,按数组顺序应用到滑动条的多区间
railStyleObject-未选中部分

代码演示

基本用法

最简单的用法。

  1. import { Component } from '@angular/core';
  2. @Component({
  3. selector: 'demo-range-basic',
  4. template: `
  5. <div class="am-demo-page">
  6. <div style="padding: 15px;font-size: 16px;">步骤条</div>
  7. <div class="am-demo-bd am-wingblank am-wingblank-lg">
  8. <div><div class="sub-title">Basic range ngModel</div></div>
  9. <div>
  10. <Range [ngModel]="valueModel"
  11. [min]="0"
  12. [max]="20"
  13. (ngModelChange)="changeModel($event)">
  14. </Range>
  15. </div>
  16. </div>
  17. <div class="am-demo-bd am-wingblank am-wingblank-lg">
  18. <div><div class="sub-title">Basic range</div></div>
  19. <div>
  20. <Range
  21. [defaultValue]="[3, 10]"
  22. [min]="0"
  23. [max]="20"
  24. (onChange)="change($event)"
  25. (onAfterChange)="afterChange($event)"
  26. ></Range>
  27. </div>
  28. </div>
  29. <div class="am-demo-bd am-wingblank am-wingblank-lg">
  30. <div><div class="sub-title">Disabled range</div></div>
  31. <div>
  32. <Range
  33. [defaultValue]="[3, 10]"
  34. [min]="0"
  35. [max]="20"
  36. [disabled]="true"
  37. (onChange)="change($event)"
  38. (onAfterChange)="afterChange($event)"
  39. ></Range>
  40. </div>
  41. </div>
  42. <div class="am-demo-bd am-wingblank am-wingblank-lg">
  43. <div><div class="sub-title">Range with customized style</div></div>
  44. <div>
  45. <Range
  46. [defaultValue]="[3, 10]"
  47. [min]="0"
  48. [max]="20"
  49. [trackStyle]="trackStyle"
  50. [railStyle]="railStyle"
  51. [handleStyle]="handleStyle"
  52. (onChange)="change($event)"
  53. (onAfterChange)="afterChange($event)"
  54. ></Range>
  55. </div>
  56. </div>
  57. </div>
  58. `,
  59. styles: [
  60. `
  61. .am-wingblank,
  62. .am-wingblank-lg {
  63. margin-left: 15px;
  64. margin-right: 15px;
  65. margin-bottom: 30px;
  66. }
  67. .sub-title {
  68. color: #888;
  69. font-size: 14px;
  70. padding: 30px 0 18px 0;
  71. margin: 0;
  72. }
  73. `
  74. ]
  75. })
  76. export class DemoRangeBasicComponent {
  77. value = [20, 50];
  78. valueModel = [4, 8];
  79. trackStyle = [{ 'background-color': 'red' }, { 'background-color': 'green' }];
  80. railStyle = {
  81. 'background-color': 'black'
  82. };
  83. handleStyle = [{ 'background-color': 'yellow' }, { 'background-color': 'gray' }];
  84. constructor() {}
  85. change(e) {
  86. console.log(e, 'change');
  87. }
  88. afterChange(e) {
  89. console.log(e, 'afterChange');
  90. }
  91. changeModel(e) {
  92. console.log(e, 'changeModel');
  93. console.log(this.valueModel, 'valueModel');
  94. }
  95. }

Range 区域选择 - 图1