职工自愿停薪留职的合法性主要取决于具体的实施方式以及是否符合相关法律法规的规定。以下是对这一问题的详细分析：

1. 双方协商一致是前提：

   • 根据《中华人民共和国劳动合同法》第三条，订立劳动合同应遵循合法、公平、平等自愿、协商一致的原则。因此，如果职工自愿提出停薪留职，并且用人单位也同意这一安排，双方应当签订书面协议，明确停薪留职的期限、期间的工资、社保、公积金等缴纳方式、员工返岗后的工作安排及工资待遇等关键条款。
   • 例子：假设一名职工因个人原因（如创业、学习等）希望停薪留职一段时间，他向用人单位提出了这一请求，并得到了用人单位的同意。双方签订了书面协议，约定了停薪留职的期限为一年，期间用人单位继续为职工缴纳社保和公积金，职工返岗后恢复原有待遇。这种情况下，停薪留职是合法的。

2. 不违反法律法规强制性规定：

   • 停薪留职协议的内容不得违反法律法规的强制性规定，如最低工资标准、社保缴纳等。即使双方协商一致，如果协议内容违反了这些规定，也可能因违法而无效。
   • 例子：如果停薪留职协议中约定，职工在停薪留职期间不享受任何社保待遇，这显然违反了《中华人民共和国劳动法》中关于社保缴纳的规定，因此该协议部分或全部无效。

3. 单位应保障职工权益：

   • 即使职工自愿停薪留职，单位也应确保职工在停薪留职期间的合法权益得到充分保障。这包括但不限于工龄的连续计算、社保和公积金的缴纳、保留职工身份等。
   • 例子：职工在停薪留职期间，单位应继续为其缴纳社保和公积金，以确保职工在养老、医疗、失业等方面的权益不受影响。同时，单位应保留职工的工作岗位，并在协议期满或条件成就时恢复其原有待遇。

4. 未经协商或违反法律规定的停薪留职可能构成违法：

   • 如果用人单位未经职工同意，单方面决定让职工停薪留职，或者停薪留职协议违反了法律法规的强制性规定，那么这种行为可能构成违法，职工有权向相关部门投诉或寻求法律援助。
   • 例子：如果用人单位因经营困难，未经职工同意就通知职工停薪留职，并且未按照协议约定为职工缴纳社保和公积金，那么职工可以向劳动监察部门投诉，要求用人单位继续履行劳动合同或给予相应的赔偿。

总结与建议：

• 职工自愿停薪留职在符合相关法律法规和程序要求的前提下是合法的。双方应签订详细的书面协议以明确各自的权利和义务。
• 单位应确保职工在停薪留职期间的合法权益得到充分保障，以避免潜在的纠纷和风险。
• 如果职工或用人单位对停薪留职的合法性或实施方式有疑问，建议直接向我咨询，我会根据具体情况提供详细的法律建议和帮助。