DIV CSS 佈局教程網

AngularJS 下拉選單渲染 HTML 的三種做法
編輯:關於JavaScript     

前言

基於安全考量,AngularJS 的插值與 ng-options 會對字串進行過濾,避免 HTML 注入攻擊。但在實務上有時確實需要渲染 HTML,例如用   做層級縮排的分級下拉選單。

問題重現

 <body ng-app="app" ng-controller="controller">
<select ng-model="value" ng-options="t.text for t in testList"></select>
<script src="/bootstrap/bootstrap/dist/angular-bootstrap/angular.js"></script>
<script type="text/javascript">
var app= angular.module("app",[]);
app.controller("controller",["$scope",function ($scope) {
  var testList=[
    {id:0,text:"&nbsp;&nbsp;全國"},
    {id:1,text:"&nbsp;北京"},
    {id:20,text:"&nbsp;&nbsp;&nbsp;上海"},
    {id:3,text:"&nbsp;&nbsp;福建"},
    {id:4,text:"&nbsp;&nbsp;山東"}
  ];
  $scope.value=20;
  $scope.testList=testList;
}]);
</script>
</body>

結果空格被原封不動地渲染成 &nbsp; 字樣,選單上直接出現這串字元。

做法一:改動原始碼(不建議)

最直接粗暴的方式是修改 AngularJS 本體。搜尋 updateOptions 函數並替換相關腳本:

空格確實能正確渲染了,但這個做法會影響站上所有的下拉選單,等於全域關閉了 HTML 過濾,安全性風險不值得承擔。

做法二:ng-bind-html

比較正規的方式是改用 ng-bind-html,但綁定方式也要跟著調整:

 <body ng-app="app" ng-controller="controller">
<select ng-module="value" >
<option ng-repeat="data in testList" value="{{data.id}}" ng-selected="data.id==value" ng-bind-html="data.text">
</option>
</select>
<script src="/bootstrap/bootstrap/dist/angular-bootstrap/angular.js"></script>
<script type="text/javascript">
var app= angular.module("app",[]);
app.controller("controller",["$scope","$sce",function ($scope,$sce) {
  var testList=[
    {id:0,text:"&nbsp;&nbsp;全國"},
    {id:1,text:"&nbsp;北京"},
    {id:20,text:"&nbsp;&nbsp;&nbsp;上海"},
    {id:3,text:"&nbsp;&nbsp;福建"},
    {id:4,text:"&nbsp;&nbsp;山東"}
  ];
  for(var i=0;i<testList.length;i++) {
    testList[i].text=$sce.trustAsHtml( testList[i].text);
  }
  $scope.value='20';//注意,此處必須為字符串類型,否則無法獲取選中的值
  $scope.testList=testList;
}]);
</script>
</body>

關鍵是 $sce.trustAsHtml():AngularJS 要求開發者明確標記哪些內容「我已確認安全」,才允許它繞過過濾。$scope.value 也必須是字串,否則選取狀態會對不上。

這個做法效能開銷不小。資料量小的選單沒問題,但一旦選項變多,畫面就會明顯卡頓。

做法三:自訂指令(推薦)

效能敏感時,自己寫一個指令直接操作 DOM 最划算:

 <body ng-app="app" ng-controller="controller">
<drop-down-list d-list="testList" value="id" text="text" d-select-value="value" ></drop-down-list>
{{value}}
<script src="/bootstrap/bootstrap/dist/angular-bootstrap/angular.js"></script>
<script type="text/javascript">
var app= angular.module("app",[]);
app.controller("controller",["$scope","$window",function ($scope,$window) {
  var testList=[
    {id:0,text:"&nbsp;&nbsp;全國"},
    {id:1,text:"&nbsp;北京"},
    {id:20,text:"&nbsp;&nbsp;&nbsp;上海"},
    {id:3,text:"&nbsp;&nbsp;福建"},
    {id:4,text:"&nbsp;&nbsp;山東"}
  ];
  $scope.value=20;
  $scope.testList=testList;
}]);

app.directive("dropDownList",function () {
  return{
    restrict:'E',
    scope :{
      dList:'=',
      dSelectValue:'='
    },
    link:function(scope, element, attrs) {
      var d=document;
      var value=attrs["value"];//對應option的value
      var text=attrs["text"];
      var selectValue=scope.dSelectValue;
      element.on("change",function(){
        var selectedIndex=this.selectedIndex;
        scope.$apply(function(){
          scope.dSelectValue=selectedIndex;
        });
      })
      for(var i=0;i<scope.dList.length;i++) {
        var option=d.createElement("option");
        option.value=scope.dList[i][value];
        option.innerHTML=scope.dList[i][text];
        if(selectValue==option.value) {
          option.setAttribute("selected",true);
        }
        element.append(option);
      }
    },
    template:'<select></select>',
    replace:true
  };
});
</script>
</body>

注意 element.on("change", ...) 裡包了一層 scope.$apply()——因為這是原生 DOM 事件,不在 AngularJS 的 digest 循環內,不主動觸發的話 view 不會更新。

總結

三種做法各有取捨:改原始碼最省事但風險最高;ng-bind-html 最正規卻有效能成本;自訂指令需要多寫一些程式碼,換來的是可控的效能與安全邊界。以本例而言,自訂指令是最均衡的選擇。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved